DrawThemeFocusRegion

Draws or erases a focus ring around a specified region.



 
pascal OSStatus DrawThemeFocusRegion (

                     RgnHandle inRegion,

                     Boolean inHasFocus);

inRegion: A value of type RgnHandle . Before calling DrawThemeFocusRegion , set the region to the position around which to draw the focus ring, in local coordinates. The focus ring is drawn outside the region that is passed in, and it can be outset a maximum of 3 pixels.
inHasFocus: A value of type Boolean . Pass true to draw the focus region. Pass false to erase the focus region.
function result: A result code; see Result Codes .

DISCUSSION

Your application can use the DrawThemeFocusRegion function to draw a theme-compliant focus ring. The presence of a focus ring indicates whether an item has keyboard focus.

VERSION NOTES

Available with Appearance Manager 1.0.1 and later.